      Welcome to the Apple ][ emulator for Palm OS PDAs.

Authors:
Hilary Cheng : hilarycheng@yahoo.com
David Schmenk: lematinracing@yahoo.com
with additions by
P. Douglas Reeder: reeder.29@osu.edu

Web Sites    : http://sf.net/projects/palmapple
Public Forum : http://sf.net/forum/forum.php?forum_id=88936

License:
Appalm ][ is licenced under the GNU General Public Licence, version 2. 
See the accompaniang file gpl.txt for details.
Appalm ][ is based on YAE, ported to the PalmOS Platform. 

Appalm ][ is open source software.  Anyone is free to modify
the source code and contribute to it. All the users are free to
use this software. But the authors are not responsibile for any
damage by THIS SOFTWARE. Please try it at Your Risk!

Preface:
Because  68000  based  Palm  devices are not greatly faster than the
Apple  ][,  emulation  performance may be less than stellar on them. 
An overclocking  utility  will  go a long way to make the emulator
more useable on anything less than a 66Mhz Clie 665C.  300 MHz
ARM processors can can run the emulator at nearly full speed.

Introduction:
What would be better than being able to take your beloved Apple
][ with you, including most of the software you had for it, all
in  your  pocket?  Here  is your chance. The Appalm ][ emulator
brings  a  64K Apple //e, no 80 column card, and 2 disk drives,
to your Palm OS based PDA. Disk images can be uploaded into the
internal  Palm  memory. Joystick emulation
is provided using the hard keys available on most Palm PDAs. 
Hi-res screens, both Sony and Palm, are supported (in color!)
and  look great too. The Sony Game Controller works very well.
Highly recommended.

Installation:
You  need  to  install  the  emulator, appalm.prc, plus the ROM
files  apple2e.rom  and slot6.rom. 

Disk images (which must be in the .dsk format) must be 
converted to Palm databases (.pdb files) before they can be
used.  Pick a disk image and use the DSK2PDB utility to create a
PalmOS  DB  of  the  disk  image.  A '-r' flag can be passed to
DSK2PDB  to  create  a  nibblized  disk  image  which  can load
slightly  faster  on the Palm but takes up 220K vs 140K for the
raw  data.  The  standard  format database performance has been
improved to the point where I don't know why you would want the
raw format.  The PDB2DSK utility converts Palm databases back
to .dsk files.  DSK2PDB.EXE and PDB2DSK.EXE are included with
the main package; DSK2PDB compiled for OS X is available as
a separate download.  For PDB2DSK under OS X, just make a link
or copy of DSK2PDB named DSK2PDB.

Running:
For most games, you need to use the "File|Load Disk 1 Images..."
menu item to load a disk image in drive 1 and check the "Reset
After Load" checkbox to boot from the disk.

On 160x160 screens, only the Apple II display will be visible.
On High-res screens, the two disk drives, with drive activity
lights and the name(s) of loaded disk images, will be shown as 
well.

The  basic  features  of the emulator are available through the
menu. Special keys and joystick options are settable there.
Setting the Apple II caps-lock (command-stroke L) may be useful
for older Apple II programs. You
can  return  to  the  Palm Launcher and run other applications.
When  you  come back to Appalm, it is in the same state as when
you  left  it.  Resetting your Palm will erase the simuator 
state, however.

Grafitti and letter keys are mapped to Apple II keys, as expected.
A number of the hard keys and virtual characters may be remapped 
to Apple II keys or game controls.  The default mappings are:
Up/Page Up		: joystick up
Down/Page Down	: joystick down
Left			: Apple II left arrow (backspace)
Right			: Apple II right arrow (ctrl-U)
Center			: Apple II return (ctrl-M)
App 1/Datebook	: joystick button 0/open-apple
App 2/Addr. book: joystick left
App 3/To Do		: joystick right
App 4/Memo		: joystick button 1/closed-apple
Alpha. keyboard : ctrl-C (Apple II interrupt program)
Numer. keyboard : Escape (ctrl-[)
Find			: [nothing]
Calculator		: [nothing]
Ronamatic stroke: [nothing]

Use the "Input|Button Mapping..." menu item to open the
Button Mapping dialog, to change these mappings.  Not all of 
these keys and strokes are available on all hardware.

A  type-ahead  buffer  is  implemented for use with an external
keyboard. You can keep typing without losing characters.  
Control characters not mapped by a hard key can be generated
with the "CTRL" menu item (command-stroke C).

Conclusion:
I wanna say thank you to David Schmenk for enhancement of Emulator
and prepare all the works of Appalm][.

And  I  can  thank Hilary for doing all the initial development
that  laid  the  groundwork for my work. Its much easier if you
have something that already works when developing new emulation
components.

